home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / BBS-Archive / DiskUtil / Misc / BTNTape.lha / readme.first < prev    next >
Text File  |  1994-04-03  |  10KB  |  223 lines
  1. ****    BTNtape:  an AmigaDOS handler for SCSI tape drives
  2. ****       Version 3.0   3/14/94
  3. ****       Freeware by Bob Rethemeyer   (drBob@cup.portal.com)
  4. ****
  5. ****    (c) Copyright 1990, 1994  Robert Rethemeyer.
  6. ****      This software may be freely distributed and redistributed,
  7. ****      for non-commercial purposes, provided this notice is included.
  8. ****      All original files must be included in the distribution.
  9.  
  10. BTNtape is the "Better Than Nothing" SCSI tape device handler.  It provides
  11. flat-file access to a SCSI tape drive from application programs using simple
  12. calls to DOS or C library I/O functions.  It can also be used with the Amiga
  13. TAR utility for disk backups.  It uses your existing SCSI adapter's device
  14. driver for access to the bus.  This is version 3.0, update to version 2.1.
  15. It fixes a number of bugs and includes a many new features.
  16.  
  17. Some advantages of BTN over other handlers and dedicated tape backup programs:
  18.   * Includes a monitor program that keeps you informed of what's happening
  19.   * Supports many standard SCSI tape drives and Amiga SCSI bus adapters
  20.   * Supports the 3M MCD-40, a non-standard SCSI tape drive
  21.   * Fully adjustable tape block size and blocking factor
  22.   * Double buffering improves streaming performance
  23.   * Includes an interface to send SCSI control commands to the drive
  24.   * Includes an interface to set drive-specific Mode Select parameters
  25.   * TAR tapes can be exchanged with Un*x systems
  26.   * DOS compatibility for use with any program. e.g. data logging applications
  27.  
  28. =================== ******> R E A D   T H I S <****** ======================
  29.  
  30. DISCLAIMER:
  31.  "This software is provided AS-IS, without warranty of any kind,
  32. either expressed or implied.  In no event will I, Robert Rethemeyer,
  33. be liable for direct, indirect, incidental or consequential damages or
  34. data loss resulting from the use or application of this software.  The entire
  35. risk as to the results and performance of this software is assumed by you."
  36.  
  37. If you do not agree with this disclaimer, do not use this software;
  38. buy commercial tape software instead.
  39.  
  40. ============================================================================
  41.  
  42. BTN got its name from the good ol' days when there was no commercial Amiga
  43. tape software, so it was definitely better than the alternative (nothing).
  44. Because commercial tape backup software is now available, the only reasons
  45. you might still want to use BTNtape would be:
  46.    * Compatibility with TAR for transporting tapes between Amiga and Un*x
  47.    * Compatibility with AmigaDOS for data logging or special applications
  48.    * You don't want to spend any money.
  49.  
  50. I claim only that this handler works with the Amiga TAR program ported by
  51. Jonathan Hue.  It might work with some recent backup programs that allow
  52. backup to a DOS file, but won't work with any that backup to Exec devices.
  53. There are other variations of TAR available, but I haven't tried them.
  54.  
  55. ==============================================================================
  56.  
  57. DISTRIBUTION:
  58.  
  59.   The distribution package should contain the following files:
  60.     btn-handler           handler binary
  61.     tapemon               monitor binary
  62.     mountlist             example mountlist entry
  63.     tape.rexx             an ARexx script to issue tape control commands
  64.     readme.first          you're reading it
  65.     changes.doc           a brief history of BTNtape
  66.     doc                   Documentation directory (PLEASE READ)
  67.       install.doc           how to install BTN
  68.       usage.doc             how to use BTN
  69.       features.doc          how to use special features of BTN
  70.       tapemon.doc           how to use the monitor program
  71.       messages.doc          explanations of handler messages
  72.       hardware.doc          information about certain hardware
  73.       drives.doc            explanation of how tape drives work
  74.     src                   Source code directory
  75.       btn.c                 main handler
  76.       btnio.c               interface to SCSI-direct
  77.       btn.h                 local include file
  78.       tapemon.c             tape monitor
  79.       tplink.h              local include file for handler/monitor interface
  80.       smakefile             SAS/C-6 make file for both handler and monitor
  81.  
  82.  
  83. COMPATIBILITY:
  84.  
  85.   You must have a SCSI adapter and software that honors the SCSI-direct
  86.   API as defined by Commodore in the "devices/scsidisk.h" include file.
  87.   All decent/recent Amiga SCSI adapters will support this API.  The list
  88.   below shows the manufacturers I know about that support SCSI-direct
  89.   (but this list I'm sure is incomplete).
  90.  
  91.   The following lists the hardware that has worked with BTN at one time
  92.   or another, for one or more persons.  Don't worry if your SCSI hardware
  93.   is not listed here, it will probably work anyway.  On the other hand,
  94.   I can't guarantee that all this hardware works in every combination.
  95.  
  96.     SCSI adapters:
  97.       * Commodore A2091
  98.       * Commodore A590
  99.       * Commodore A3000/A4000/etc. (built-in)
  100.       * GVP (various models)
  101.       * HardFrame
  102.       * Nexus
  103.       * Commodore 2090A- see hardware.doc file.
  104.       * Supra (all types) Series III or above driver
  105.       * Original Trumpcard- with 2.0F software, 4.0 ROMs, Interrupt 2 jumper.
  106.       * Trumpcard Pro
  107.       * Xetec
  108.       * Spartan- with v34.1 or above software (may need OV-0 in startup)
  109.       * Ashcom SCSI
  110.  
  111.     Sequential tape drives:
  112.       * Commodore A3070 (Caliper CP150)
  113.       * Archive 2060S, 2120S, 2150S, 2250S, 5945S
  114.       * Wangtek 5099, 5150ES, 5525ES
  115.       * Wangtek DAT 6200H, 1300
  116.       * Sankyo CP-150SE
  117.       * Tandberg 3620, 3640, 3660, 3820
  118.       * Teac MT-2ST Cassette (maybe)
  119.       * Emulex MT-02 SCSI/QIC-36 tape adapter
  120.       * Exabyte EXB-8200/8500 8mm Cartridge Tape Subsystem
  121.       * Sony SDT-1000 DAT drive
  122.       * HP 35480A DAT drive
  123.       * DEC TK50
  124.  
  125.     Direct-access tape drives:
  126.       * 3M MCD-40 40MB cartridge tape drive
  127.       * Jasmine DT40 (Braemar, 3M derivative?)
  128.       * TallGrass (model unknown, 3M derivative?)
  129.  
  130.  
  131. HOW IT WORKS
  132.  
  133.      BTNtape acts as a bridge between AmigaDOS and your tape drive by
  134.      using the SCSI-direct API provided by your hard disk SCSI adapter.
  135.      It makes the tape drive look like a sequential data file,
  136.      so programs operating under AmigaDOS can access the tape drive
  137.      like most other data files, using calls to Open(), Read(), Write(),
  138.      and Close(), or through the C library I/O functions fread(), etc.
  139.  
  140.      BTN does NOT make the drive look like a file system.  Tape archive
  141.      utilities such as TAR do this, in one sense, by storing a little
  142.      file system inside a single tapefile.
  143.  
  144.      As your application (such as TAR) makes read or write requests,
  145.      AmigaDOS passes these requests as messages to BTN.  BTN translates
  146.      these requests into SCSI commands to the tape drive as necessary.
  147.      BTN holds tape data in memory buffers and exchanges data from
  148.      these buffers with your application.
  149.  
  150.      Two buffers are maintained so that one buffer can be used by DOS
  151.      while the other is exchanging data with the drive.  With the
  152.      multitasking nature of the Amiga, this should help keep the tape
  153.      in motion (but it may not help much with non-DMA SCSI adapters).
  154.  
  155.      In write mode, the handler collects DOS data in one buffer while
  156.      the previously filled buffer is being written to tape.  In read mode,
  157.      the handler reads ahead on the tape to fill one buffer while
  158.      DOS gets data from the previously read buffer.  Seeks are implemented
  159.      as a restricted form of read which does not return any data.
  160.  
  161.      The handler does not write or expect anything special on
  162.      the tape for itself.  That is to say, the data written on the
  163.      tape is your raw data, nothing else.
  164.  
  165.  
  166. SUPPORT
  167.  
  168.   I will try to provide support for this handler, especially for bug fixes,
  169.   as my limited time and resources allow, but I do not guarantee anything.
  170.   That's why it's freeware-- shareware would imply a guaranteed level
  171.   of support that I may not be able to give.
  172.  
  173.   If you want to distribute a version of BTNtape that you have modified
  174.   or enhanced, you may only do so under the following conditions:
  175.       * do not call yours BTNtape; call it something else to avoid confusion
  176.       * your version must also be distributed as FREEWARE
  177.       * your distribution must also include all the source code
  178.       * keep my name somewhere in the list of authors
  179.       * I shall not be liable for any damages caused by your version
  180.       * I cannot help you debug or support your version
  181.  
  182.  
  183. CONTACTING THE AUTHOR
  184.  
  185.   Email: (I don't log-on every day, so there may be a response delay.)
  186.  
  187.           Internet = drBob@cup.portal.com
  188.  
  189.           CompuServe = 73014,2400
  190.  
  191.   USmail: Robert Rethemeyer
  192.           979-4 Belmont Terrace
  193.           Sunnyvale, CA  94086
  194.           USA
  195.  
  196.   BTNtape is FREEWARE, do not send money or gifts.
  197.  
  198.   IMPORTANT!!  If you want to contact me about a problem, you need to
  199.   include with your mail the following information as applicable:
  200.       *  your configuration: model of Amiga, SCSI adapter, and tape drive
  201.       *  the version of BTN you are using
  202.       *  a copy of your mountlist entry for TAPE:
  203.       *  a capture of the output from TAPEMON.  Just redirect its
  204.              output to a file:     TAPEMON >filename
  205.       *  a verbal description of what happens to the drive and/or Amiga
  206.              (e.g.  tape doesn't move, smoke issues from Amiga, etc.)
  207.       *  any other info that may help me figure out what's going on.
  208.           Remember, I'm not there to see what is happening, and I
  209.           probably don't have your hardware setup available to recreate
  210.           the problem.  I have only your description to go by.
  211.  
  212.  
  213. ACKNOWLEDGEMENTS
  214.  
  215.    I wish to thank those who helped make BTNtape v3.0 possible:
  216.       BETA TESTERS:  Serenella Ciongoli, Thad Floryan,
  217.                      Frank Perricone, Bill Seymour
  218.       HARDWARE LOAN: Scott Blackledge
  219.  
  220.    Contributors to previous BTN versions are listed in the changes.doc file.
  221.    It's been 3 years since the last version- my apologies if I forgot someone.
  222.  
  223.